Implementation Plan for Post Revision Commands

• Explore repository structure and understand existing patterns
• Create Post_Revision_Command.php file with two commands:
  • wp post revision restore <post_id> - Restore a revision with the given ID
  • wp post revision diff <from> <to> - Compare/diff two revisions with CLI-friendly colored output
• Register the command in entity-command.php
• Add command to composer.json commands list
• Create Behat feature tests for the new commands
• Address all code review feedback
• Fix incomplete test scenario for diff between two revisions
• Replace HTML diff output with CLI-friendly colored output
• All code quality checks passing ✓

Commands

wp post revision restore <revision_id>

Restores a post to the specified revision using WordPress's native wp_restore_post_revision().

wp post revision restore 123
# Success: Restored revision 123.

wp post revision diff <from> [<to>] [--field=<field>]

Compares revision content using CLI-friendly colored diff output. Auto-detects parent post when <to> is omitted.

# Compare two revisions
wp post revision diff 123 456

# Compare revision with current post
wp post revision diff 123

# Compare specific fields
wp post revision diff 123 456 --field=post_title

Diff Output

The diff command displays changes with color coding:

• Red lines with - prefix = Deleted lines
• Green lines with + prefix = Added lines
• Default color with prefix = Unchanged lines
• Yellow header lines = Revision metadata (title, date, ID)

Example output:

--- Original Post (2024-01-01 12:00:00) - ID 123
+++ Modified Post (2024-01-02 13:00:00) - ID 456

  Line 1
- Line 2
+ Line 2 modified
  Line 3

Supports 15 post fields: post_title, post_content, post_excerpt, post_name, post_status, post_type, post_author, post_date, post_date_gmt, post_modified, post_modified_gmt, post_parent, menu_order, comment_status, ping_status.

Implementation

• src/Post_Revision_Command.php: New command class using Text_Diff class directly with custom CLI renderer
• entity-command.php: Registers post revision namespace
• composer.json: Adds command entries for autocompletion
• phpcs.xml.dist: Excludes new command from prefix rules
• features/post-revision.feature: 7 test scenarios covering success and error cases

• Fixes wp post revisions #547

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.